Event: "add"

Description: Sets an add handler to exicute when one or more elements are added to the specified DOM container element.

Returns: domElement or matching node array, or $A object if chained.

Note: This event utilizes the Mutation Observer API.
https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver

Example:

  // Bind an add handler to a DOM container element.

  $A(targetContainerElement).on("add", function(MutationObject, targetContainerElement, arrayOfAddedNodes, BoundObjectOrDC, SavedData) {
    // Do something with arrayOfAddedNodes
    // BoundObjectOrDC populates when the targetContainer  is bound using $A.bindObjects(), or is bound to a DC instance.
    // SavedData populates when saved event parameters are specified using the $A.on event syntax. (Help/$A API/DOM Events/On) 
  });